PATHMac OS 8 and 9 Developer Documentation > Human Interface Toolbox > Window Manager >

Programming With the Mac OS 8.5 Window Manager

'wind'

Windows can be stored in flattened collections in extensible window resources of type 'wind' . You create a window from a 'wind' resource when you call the function CreateWindowFromResource . For more details on collections, see "Collection Manager" in Inside Macintosh: QuickDraw GX Environment and Utilities .

Note that due to the complexity of this format, it is possible to create 'wind' resources using Rez, but it is not possible to DeRez them. DeRez cannot currently handle multiple undefined labels as used in this type definition.

Note, too, that your application's 'wind' resources must have resource ID numbers greater than 127.

There are currently two default collection items defined for the extended window resource. One default item is a structure of type BasicWindowDescription , which defines a standard Mac OS 8.5 Window Manager window. The other default item is a Pascal title string for the window. Future versions of the Window Manager may add new default collection items to the format without the application's knowledge.

Application developers are welcome to extend 'wind' resources with new collection items as they see fit (although zero-length items aren't supported). However, developers may not define new collection items using the 'appl' collection item tag, which is reserved for use by Apple Computer, Inc. See 'wind' Resource Default Collection Item Constants for details on the tags and the IDs that are reserved for identifying default items.

The format of a compiled 'wind' resource is based upon that of a 'flac' , or flattened collection, resource. Figure 3-1 illustrates the format of this resource.

Figure 3-1  Structure of a compiled 'wind' resource

A compiled version of the 'wind' resource contains the following elements:

• A 32-bit value identifying the version of the 'wind' resource's format. This value should be set to 0x00010000 .
• Default attribute bits for the collection as a whole; 0 for none.
• The total number of items in the collection.
• An array of items, sorted by tag and ID. Each entry in the item array has corresponding data in the data array. Each item array entry must contain these elements:
• A tag identifying the item type.
• An ID identifying the particular item.
• Thirty-two attributes, each represented by one bit flag, stored in a 32-bit word. The bits are numbered from 0 to 31, with bit 31 being the high bit. The upper 16 bits of an item's attributes are reserved for use by Apple Computer, Inc. The lower 16 bits are attributes that you can define for purposes suitable to your application. Currently, two of the reserved attributes are defined:

Bit 31	The lock attribute. When an item has this attribute set, attempts to replace the item result in an error.
Bit 30	The persistence attribute. When an item has this attribute set, the item is included when the collection is flattened.

• An offset to the item's data.
• A value representing the total size of all the items' data in the collection's data array.
• An array of data, corresponding to the array of items. Each entry in the data array must be in the same order as its corresponding entry in the item array. Each data array entry must contain these elements:
• A value representing the size of the data for the item.
• The data for the item, which can be of variable size.
• Alignment bytes. Zero or one bytes used to make the previous data string end on a word boundary.